package cn.good.yan.t6.t2;

import jakarta.validation.Constraint;
import jakarta.validation.Payload;

import java.lang.annotation.*;

/**
 * 6 数据校验：Validation  - 验证 自定义效验
 *    1. ：自定义校验注解
 * @author shengren.yan
 * @create 2023-09-14
 */
// 用于指定注解的使用范围，包括方法、字段、注解类型、构造函数、参数
@Target({ElementType.METHOD, ElementType.FIELD, ElementType.ANNOTATION_TYPE, ElementType.CONSTRUCTOR, ElementType.PARAMETER})
// 用于指定注解的生命周期
@Retention(RetentionPolicy.RUNTIME)
// 用于指示该注解应该被包含在生成的文档中
@Documented
// @Constraint 标记该注解为校验注解，并指定对应的校验器类 -- 指定规则的逻辑
@Constraint(validatedBy = {CannotBlankValidator.class})
public @interface CannotBlank {

    //默认错误消息
    String message() default "不能包含空格";

    //分组 - 可以指定校验器在哪个分组生效
    Class<?>[] groups() default {};

    //负载 - Payload 可在自定义校验器中使用
    Class<? extends Payload>[] payload() default {};

    //指定多个时使用
    @Target({ElementType.METHOD, ElementType.FIELD, ElementType.ANNOTATION_TYPE, ElementType.CONSTRUCTOR, ElementType.PARAMETER, ElementType.TYPE_USE})
    @Retention(RetentionPolicy.RUNTIME)
    @Documented
    @interface List {
        CannotBlank[] value();
    }

}
